home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 2 / Gold Medal Software Volume 2 (Gold Medal) (1994).iso / prog / envi_103.arj / ENVI-MAN.DOC < prev    next >
Text File  |  1993-04-30  |  53KB  |  1,499 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                  Ç    ──────────────────────────────────────────── 
  8.                Ç ┼┐════════════════════════════════════════════   
  9.               ╔╬╗ ┴                                               
  10.               ╨║╨ ┐                                               
  11.               ╔╩╗ ┴                                               
  12.               ╨ ╨                                                 
  13.  
  14.   ▒▒▒▒▒▒▒▒▄ ▒▒▄   ▒▒▄ ▒▒▄   ▒▒▄   ▒▒▄            ▒▒▄   ▒▒▄    ▒▒▄    ▒▒▄   ▒▒▄
  15.   ▒▒█▀▀▀▀▀▀ ▒▒▒▄  ▒▒█ ▒▒█   ▒▒█   ▒▒█            ▒▒▒▄ ▒▒▒█   ▒▒▒▒▄   ▒▒▒▄  ▒▒█
  16.   ▒▒▒▒▒▒▒▒▄ ▒▒█▒▒▄▒▒█  ▒▒▄ ▒▒█▀   ▒▒█    ▒▒▒▒▒▒▄ ▒▒▒█ ▒▒▒█  ▒▒█▀▒▒▄  ▒▒█▒▒▄▒▒█
  17.   ▒▒█▀▀▀▀▀▀ ▒▒█ ▀▒▒▒█   ▒▒▒▒█▀    ▒▒█     ▀▀▀▀▀▀ ▒▒█▒▒▄▒▒█  ▒▒▒▒▒▒█  ▒▒█ ▀▒▒▒█
  18.   ▒▒▒▒▒▒▒▒▄ ▒▒█   ▒▒█    ▒▒█▀     ▒▒█            ▒▒█▒▒█▒▒█ ▒▒█▀▀▀▒▒▄ ▒▒█   ▒▒█
  19.    ▀▀▀▀▀▀▀▀  ▀▀    ▀▀     ▀▀       ▀▀             ▀▀ ▀▀ ▀▀  ▀▀    ▀▀  ▀▀    ▀▀
  20.  
  21.  
  22.  
  23.  
  24.  Welcome to ENVI-MAN, a utility program to assist in analyzing and managing the
  25.                                 Environment data!
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.                  ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  41.  
  42.                               U S E R   M A N U A L
  43.  
  44.                                    Version 1.0
  45.  
  46.                             Release    April 26, 1991
  47.  
  48.                  ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
  49.  
  50.                        Copyright 1991-1992 by Micrometric.
  51.                               All rights reserved.
  52.  
  53. ENVI-MAN is distributed as SHAREWARE and, as such, may be copied and shared on a
  54. private  non-commercial basis with others  in its unmodified  form. Liability is
  55. limited to  replacing the software  for registered users. There  is no liability
  56. for any damage or loss caused by this software, directly or indirectly. 
  57.                ┌────────────────────────────────────────────────┐ 
  58.                │             ┌───────┐                          │█
  59.                │        ┌────┴──┐    │                (R)       │█
  60.                │      ──│       │O   │───────────────────       │█
  61.                │        │  ┌────┴╨─┐ │  Association of          │█
  62.                │        │  │       │─┘  Shareware               │█
  63.                │        └──│   O   │    Professionals           │█
  64.                │      ─────│   ║   │─────────────────────       │█
  65.                │           └───╨───┘    MEMBER                  │█
  66.                └────────────────────────────────────────────────┘█
  67.                 ██████████████████████████████████████████████████
  68.  
  69. If you have problems with this program, or want to send comments, manual correc-
  70. tions, or enhancement suggestions, you may call or mail them to:
  71.  
  72.           Micrometric
  73.           98 Dade Avenue
  74.           Sarasota, FLorida  34232-1609  USA
  75.  
  76.           Tech Support  . . . (813) 377-2515
  77.           FAX   . . . . . . . (813) 377-2091
  78.           Support BBS   . . . (813) 371-2490
  79.  
  80. The Micrometric Software Support BBS provides availability and technical support
  81. for  the Micrometric ■■■■-MAN series  of shareware programs.  First time callers
  82. have  access to the  board and  can leave  messages or  download replies/current
  83. shareware  releases. Registered  users may  also download  the latest  Beta test
  84. software releases, when available.
  85.  
  86. Additionally,  you can  send routed  E-Mail via  the RIME(tm)  network to  David
  87. Groome at the  ->ACTION node in the ASP, Laser, Batch, Common, or Shareware con-
  88. ferences. I also check CompuServe (71631,744), but only on an infrequent basis.
  89.  
  90.  
  91. PKZIP, PKUNZIP and PKSFX are trademarks of PKWARE, Inc.
  92. MS-DOS is a registered trademark of the Microsoft Corporation.
  93. IBM PC, XT, AT and PC-DOS are registered trademarks of the IBM Corporation.
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106. 2
  107.  
  108.  
  109.                                                                TABLE OF CONTENTS
  110.  
  111.  
  112. INTRODUCTION  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    5
  113.    Major Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    5
  114.    System Requirements  . . . . . . . . . . . . . . . . . . . . . . . . . .    5
  115.    Manual Format  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    5
  116.       Page layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    5
  117.       Brackets and parentheses  . . . . . . . . . . . . . . . . . . . . . .    5
  118.       Computer key conventions  . . . . . . . . . . . . . . . . . . . . . .    5
  119.       Action steps  . . . . . . . . . . . . . . . . . . . . . . . . . . . .    5
  120.       ■■■■-MAN programs . . . . . . . . . . . . . . . . . . . . . . . . . .    6
  121.       Shareware distributed documentation manual  . . . . . . . . . . . . .    6
  122.    Shareware  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    6
  123.  
  124. INSTALLING THE SYSTEM   . . . . . . . . . . . . . . . . . . . . . . . . . .    9
  125.    From a Diskette Vendor . . . . . . . . . . . . . . . . . . . . . . . . .    9
  126.    From a BBS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    9
  127.    Registered Version . . . . . . . . . . . . . . . . . . . . . . . . . . .    9
  128.  
  129. RUNNING ENVI-MAN  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   15
  130.    Options  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   15
  131.    Requested Environment Memory . . . . . . . . . . . . . . . . . . . . . .   15
  132.    Shareware message  . . . . . . . . . . . . . . . . . . . . . . . . . . .   15
  133.  
  134. MASTER AND PROGRAM
  135. ENVIRONMENTS  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   17
  136.    Master Environment . . . . . . . . . . . . . . . . . . . . . . . . . . .   17
  137.    Program Environment  . . . . . . . . . . . . . . . . . . . . . . . . . .   17
  138.    Master Environment Expansion . . . . . . . . . . . . . . . . . . . . . .   18
  139.  
  140. ENVI-MAN OPERATION  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   21
  141.    Program Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   21
  142.    Environment Data Display . . . . . . . . . . . . . . . . . . . . . . . .   22
  143.    Environment Space Remaining Display  . . . . . . . . . . . . . . . . . .   23
  144.    Additional Environment Space Required Display  . . . . . . . . . . . . .   23
  145.    Available Environment Space ERRORLEVEL calculation . . . . . . . . . . .   24
  146.  
  147. ENVI-MAN BATCH
  148. FILE EXAMPLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   25
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.                                                                                3
  165.  
  166.            TABLE OF CONTENTS                          ENVI-MAN Version 1.0
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222. 4
  223.  
  224.  
  225.                                                                     INTRODUCTION
  226.  
  227. ENVI-MAN is a  utility that accomplishes  two major function.  The first is  the
  228. ability to  display all of  the current environment  strings and data  about the
  229. environment such  as the location,  size and  space availability  of the  Master
  230. environment.  The second function is to let  a batch file know how much environ-
  231. ment space is currently available and to provide a graceful exit if there is not
  232. enough. The routine may also show that, under certain circumstances, the size of
  233. the  master  environment can  be  expanded  with no  change  being  made to  the
  234. CONFIG.SYS file.
  235.  
  236. Major Features  
  237.  
  238. *  Data display option  showing each  of the current  environment strings  along
  239.    with its length. Summary  data on the Master environment size,  current envi-
  240.    ronment size and available environment space is also shown.
  241. *  Single  line summary  display option  of the  available environment  space as
  242.    reported by ERRORLEVEL.
  243. *  Sets the ERRORLEVEL variable  to the available environment  space for use  in
  244.    testing within batch files.
  245. *  Option  to calculate the available environment space with or without possible
  246.    free memory located above the master environment.
  247. *  Option to compare and  test the available environment space  with a requested
  248.    amount of needed environment memory.
  249. *  May be run from  the DOS prompt to display data or from  a batch file to test
  250.    available environment space.
  251. *  Written in assembler for fast operation and small size.
  252.  
  253. System Requirements  
  254.  
  255. ENVI-MAN will run  on an IBM PC, XT, AT or  true compatibles. It has been tested
  256. with PC-DOS/MS-DOS operating systems, version 3.0 through version 5.0.
  257.  
  258. Manual Format  
  259.  
  260. This manual is divided into several  introductory chapters followed by a chapter
  261. for each ENVI-MAN function menu. The  format of these chapters, and the informa-
  262. tion presented therein, has been standardized using the following conventions.
  263.        
  264. Page layout - Each page has a header detailing  the chapter and the program ver-
  265. sion covered. A footer displays the manual page number.
  266.  
  267. Brackets and parentheses  - Brackets, [...], are  used in the manual  and in the
  268. help  screens  to specify  what should  be entered  in  response to  the current
  269. prompt.  If a character string is to be entered, the type of character is noted,
  270. such as ALPHA, NUMERIC, ANY, etc. Parentheses, (..), are used for comments.
  271.  
  272. Computer key  conventions - Keys  specified in the manual  text that are  not in
  273. entry brackets are shown as reversed  text, such as  ESCAPE . All key references
  274. are in capital letters for clarity.
  275.  
  276. Action steps  - Some procedures  may require selection  from a menu  of options,
  277. inputting data, or following a sequence of operations. Most manual sections will
  278. first give an overview of the function or task under  discussion and then detail
  279.  
  280.                                                                                5
  281.  
  282.            INTRODUCTION                               ENVI-MAN Version 1.0
  283.  
  284. the various  action operating procedures. In order to make this manual easier to
  285. use, a symbol, -> , marks the beginning of each of these action operating proce-
  286. dures.
  287.  
  288. ■■■■-MAN programs - The  general group of  shareware programs by Micrometric  is
  289. referred to by the name ■■■■-MAN. It may also be used in reference to a specific
  290. program in that group.
  291.  
  292. Shareware distributed documentation manual - The documentation file  included on
  293. the shareware distribution diskette contains the same information as the printed
  294. and bound  manual, supplied as  part of registration,  with two exceptions,  the
  295. result of  the word processor, formatting,  and printer used. The  first is that
  296. all of  the control display characters  (ASCII 1-31) and the  reverse print key-
  297. board codes are NOT  shown properly. Finally, bolding, underlining,  and special
  298. symbols are NOT present.
  299.  
  300. Shareware  
  301.  
  302. ENVI-MAN is being distributed  as SHAREWARE. The SHAREWARE concept  allows users
  303. to examine a  program on a trial basis,  at no (or minimal) charge,  before pur-
  304. chasing it.  In addition,  by decreasing  marketing costs,  professional quality
  305. software  may be distributed for a fraction of  the cost of a comparable commer-
  306. cial product. Regardless of whether you  register the program, please help  dis-
  307. tribute ENVI-MAN by sharing unmodified copies of it and its files with others.
  308.  
  309. You are hereby  granted the right to use the ENVI-MAN  program for a thirty (30)
  310. day evaluation  period. If you  find ENVI-MAN of  value, and continue to  use it
  311. after this  evaluation period,  YOU MUST  REGISTER YOUR PROGRAM  USE. This  will
  312. provide you with:
  313.  
  314.    *  A 7" x 8 1/2" printed and bound manual.
  315.    *  ENVI-MAN phone or mail support for one year.
  316.    *  Notification of the next ENVI-MAN release.
  317.    *  Ability to suppress the  shareware registration reminder message displayed
  318.       at the end of the program.
  319.    *  An installation/update/registration brand program.
  320.    *  Sincere thanks for your support of the SHAREWARE concept.
  321.  
  322. A Single System  Program Registration entitles the user to  unlimited use of the
  323. ENVI-MAN program on a single computer. 
  324.  
  325. A Site  License Program Registration entitles  the user to unlimited  use of the
  326. ENVI-MAN program on  all computers,  including networks, at  a single  corporate
  327. location.
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338. 6
  339.  
  340.            ENVI-MAN Version 1.0                               INTRODUCTION
  341.  
  342. Program Registration, Single System . . .   $20.
  343.      Includes latest version diskette and manual
  344. Program Registration, Site License  . . .  $200.
  345.      Includes latest version diskette and manual
  346. Latest Version Diskette only  . . . . . .   $10.
  347. Shipping - Surface (for outside of USA/Canada only)$5.
  348. Shipping - Air (for outside of USA/Canada only)$10.
  349. COD and credit card orders, add 5%
  350. Florida residents, add 7% sales tax
  351.  
  352. ADDRESS:  Micrometric
  353.           98 Dade Avenue
  354.           Sarasota, FLorida 34232-1609 USA
  355.  
  356. PHONE:    Tech Support  . .   (813) 377-2515
  357.           FAX . . . . . . .   (813) 377-2091
  358.           Support BBS . . .   (813) 371-2490
  359.           Order Line  . . .   (800) 929-0184
  360.  
  361. For ease in program registration, a registration order form is included with the
  362. distribution files.
  363.  
  364. This program is produced by a member of the Association of Shareware Profession-
  365. als (ASP). ASP wants to make sure that the shareware principal works for you. If
  366. you are  unable to resolve  a shareware-related  problem with an  ASP member  by
  367. contacting the  member directly, ASP may be able  to help. The ASP Ombudsman can
  368. help you resolve a dispute or problem  with an ASP member, but does not  provide
  369. technical support  for members' products. Please  write to the  ASP Ombudsman at
  370. 545 Grover Road, Muskegon, MI 49442-9427, send a CompuServe message via easyplex
  371. to ASP Ombudsman 70007,3536, or by FAX to the ASP FAX number: (616) 788-2765. In
  372. communications with the Ombudsman  please include a telephone number  and/or FAX
  373. if available.
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.                                                                                7
  397.  
  398.            INTRODUCTION                               ENVI-MAN Version 1.0
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454. 8
  455.  
  456.  
  457.                                                          INSTALLING THE SYSTEM  
  458.  
  459. From a Diskette Vendor  
  460.  
  461. If  the ENVI-MAN program  has been obtained  from a diskette  vendor, you should
  462. follow  any of their instruction on unpacking/installing the programs (if indeed
  463. they have separate instructions.) The  program, and its files, is  normally sup-
  464. plied  as a self extracting  file whose name is "ENVI@xxx.EXE"  (xxx is the ver-
  465. sion, such as "ENVI@100").
  466.  
  467. This file  should first be copied to a directory  on your hard disk. This direc-
  468. tory may be a new  one, such as one  named "ENVI", and created specifically  for
  469. ENVI-MAN, or a  current one, such as  "UTILITY", that has  other programs/files.
  470. For information on creating a separate directory, see your DOS manual.
  471.  
  472.  NOTE    FOR BEST OPERATION, ALL  REQUIRED ENVI-MAN FILES *SHOULD* BE  PLACED ON
  473.          PATH REFERENCED SUBDIRECTORIES!
  474.  
  475. Once the file is copied  to the desired hard  disk directory, at the DOS  prompt
  476. change to  this  drive directory,  and then  type  the EXE  file  name (such  as
  477. "ENVI@100") and press  ENTER . This will unpack all of the ENVI-MAN files.
  478.  
  479. From a BBS  
  480.  
  481. If the ENVI-MAN file  was downloaded from a  Bulletin Board, it should  first be
  482. copied to a directory as  defined above, and then unpacked, using  whatever pro-
  483. gram is specified by the  Bulletin Board. It is normally distributed with a name
  484. of "ENVI@vvv.ZIP" (vvv is the version) or "ENVIMN.ZIP".
  485.  
  486. Registered Version  
  487.  
  488. Registered users should use the program "INSTALL", that  is supplied upon regis-
  489. tration. This program will create a registration file which will,  in turn, sup-
  490. press the shareware registration reminders.
  491.  
  492. -> To install ENVI-MAN on your hard disk, follow the steps detailed below:
  493.  
  494.    1. Place the ENVI-MAN distribution diskette in your floppy diskette drive.
  495.  
  496.    2. At the DOS prompt, change to  the drive in which the distribution diskette
  497.       is located. For example, if the diskette  was placed in drive A, type   A 
  498.        :  and press  ENTER .
  499.  
  500.    3. Type  I   N   S   T   A   L   L  and press  ENTER . The  installation pro-
  501.       gram will then be loaded, and its display should be as shown below.
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.                                                                                9
  513.  
  514.            INSTALLING THE SYSTEM                      ENVI-MAN Version 1.0
  515.  
  516. ╒═╡ INSTallation MANagement Program/One System   Started at═>07-31-92 03:00 ╞═╕ 
  517. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  518. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  519. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  520. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  521. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  522. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  523. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  524. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  525. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  526. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  527. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  528. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  529. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  530. │░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ 
  531. │░     ░░▄    ░░▄   ░░▄░░░░░░░░▄░░░░░░░░▄         ░░▄   ░░▄   ░░▄   ░░▄   ░░▄░│ 
  532. │░  Ç═ ░░█    ░░░▄  ░░█░░█▀▀▀▀▀▀ ▀▀░░█▀▀▀   ░░▄   ░░░▄ ░░░█  ░░░░▄  ░░░▄  ░░█░│ 
  533. │░ ┌┼┐ ░░█    ░░█░░▄░░█░░░░░░░░▄   ░░█     ░░░█   ░░░█ ░░░█ ░░█▀░░▄ ░░█░░▄░░█░│ 
  534. │░ ┌┴┐ ░░█    ░░█ ▀░░░█ ▀▀▀▀▀░░█   ░░█      ░░█   ░░█░░▄░░█ ░░░░░░█ ░░█ ▀░░░█░│ 
  535. │░═┴═┴═░░█    ░░█   ░░█░░░░░░░░█   ░░█     ░░░░▄  ░░█░░█░░█░░█▀▀▀░░▄░░█   ░░█░│ 
  536. │░      ▀▀     ▀▀    ▀▀ ▀▀▀▀▀▀▀▀    ▀▀      ▀▀▀▀   ▀▀ ▀▀ ▀▀ ▀▀    ▀▀ ▀▀    ▀▀░│ 
  537. ╘╡ INSTALL/1 Version 3.00 Copyright 1990-92 Micrometric, All Rights Reserved ╞╛ 
  538. F1>Help│ESC>Exit│ENTER/[char]>Select│  HomeEnd│                                 
  539.  
  540.     NOTE    Context sensitive help is available from this point in the installa-
  541.             tion program on, by pressing the  F1  key. 
  542.  
  543.    4. If a color video card is detected, the following prompt will be displayed.
  544.                     ┌──────────────────────────────────────┐
  545.                     │ ╔═╡ Color Monitor Card Detected ╞═╗  │
  546.                     │ ║ Use the color display           ║█ │
  547.                     │ ║ Force a monochrome display      ║█ │
  548.                     │ ╚═════════════════════════════════╝█ │
  549.                     │  ███████████████████████████████████ │
  550.                     └──────────────────────────────────────┘
  551.  
  552.       -> If your system has a color monitor, press  U .
  553.       -> If your system has a monochrome or LCD display, press  F .
  554.  
  555.    5. A selection list of all path referenced directories is next displayed.
  556.  
  557.     NOTE    FOR BEST OPERATION, ALL  REQUIRED ENVI-MAN FILES *SHOULD* BE  PLACED
  558.             ON PATH REFERENCED SUBDIRECTORIES!
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570. 10
  571.  
  572.            ENVI-MAN Version 1.0                      INSTALLING THE SYSTEM
  573.  
  574.                  ┌────────────────────────────────────────────┐
  575.                  │ ┌─┤ Select the INSTALLATION DIRECTORY ├─┐  │
  576.                  │ │ C:\BAT                                │█ │
  577.                  │ │ C:\DOS-500                            │█ │
  578.                  │ │ C:\UTILITY                            │█ │
  579.                  │ │ C:\ZIP                                │█ │
  580.                  │ │ C:\                                   │█ │
  581.                  │ │ User Defined Drive-Directory Path     │█ │
  582.                  │ └───────────────────────────────────────┘█ │
  583.                  │  █████████████████████████████████████████ │
  584.                  └────────────────────────────────────────────┘
  585.  
  586.       -> To cancel the installation program at this point, press  ESCAPE .
  587.       -> To select one  of the path referenced  directories on which to  install
  588.          ENVI-MAN, move the highlight bar to the desired one and press  ENTER .
  589.       -> To  specify  a  non-path  referenced  directory  on  which  to  install
  590.          ENVI-MAN, press  U  and then press  ENTER . A data entry window for the
  591.          installation path will then be displayed, as shown below (with an exam-
  592.          ple path already entered).  Enter the desired drive and  directory path
  593.          on which to install ENVI-MAN,  using the control keys described on  the
  594.          bottom help line.
  595.    ┌────────────────────────────────────────────────────────────────────────┐
  596.    │ ┌─┤ Enter Path ├────────────────────────────────────────────────────┐  │
  597.    │ │ C:\ENVI.......................................................... │█ │
  598.    │ └───────────────────────────────────────────────────────────────────┘█ │
  599.    │  █████████████████████████████████████████████████████████████████████ │
  600.    └────────────────────────────────────────────────────────────────────────┘
  601.  
  602.          -> To cancel defining the path, press  ESCAPE . The program will return
  603.             to directory selection.
  604.          -> To  accept the path  as entered  and edited,  press  ENTER .  If the
  605.             specified directory does not  currently exist, the following message
  606.             will be displayed.
  607.      ┌────────────────────────────────────────────────────────────────────┐
  608.      │ ┌─┤ MESSAGE ├───────────────────────────────────────────────────┐  │
  609.      │ │ The drive-directory path as entered DOES NOT currently exist. │█ │
  610.      │ │ This directory WILL NOW BE created.                           │█ │
  611.      │ └───────────────────────────────────────────────────────────────┘█ │
  612.      │  █████████████████████████████████████████████████████████████████ │
  613.      └────────────────────────────────────────────────────────────────────┘
  614.  
  615.             -> To cancel creation of this directory, press  ESCAPE .
  616.             -> To create the  specified directory, press  ENTER .  If the speci-
  617.                fied drive  is invalid or the  requested installation directory's
  618.                parent  does not exist, an error message will be displayed. Press
  619.                any key, and then re-edit the installation path.
  620.  
  621.    6. If more than one system is available for installation, a SYSTEM TO INSTALL
  622.       selection menu will be displayed, as shown below.
  623.  
  624.  
  625.  
  626.  
  627.  
  628.                                                                               11
  629.  
  630.            INSTALLING THE SYSTEM                      ENVI-MAN Version 1.0
  631.  
  632.      ┌─────────────────────────────────────────────────────────────────────┐
  633.      │ ╔═══╡ Select the SYSTEM TO INSTALL ╞═════════════════════════════╗  │
  634.      │ ║ ENVI-MAN  Environment data summary, environ. space remaining   ║█ │
  635.      │ ║ FILE-MAN  Menu driven DOS file manager, directory tree         ║█ │
  636.      │ ║ LASR-MAN  Print text files on a laser printer, 36 print styles ║█ │
  637.      │ ║ MENU-MAN  Display custom user selection menus from batch files ║█ │
  638.      │ ║ PATH-MAN  Determines if a file is on a PATH directory          ║█ │
  639.      │ ╚════════════════════════════════════════════════════════════════╝█ │
  640.      │  ██████████████████████████████████████████████████████████████████ │
  641.      └─────────────────────────────────────────────────────────────────────┘
  642.  
  643.       -> To terminate the installation program at this point, press  ESCAPE .
  644.       -> To select the  SYSTEM TO INSTALL, press its highlighted  letter or move
  645.          the highlight bar to in with the arrow keys and press  ENTER .
  646.  
  647.    7. A list of all ENVI-MAN files is next displayed, along with an INSTALLATION
  648.       FUNCTION menu. The normal sequence of operations is to first "Install" the
  649.       ENVI-MAN program and files, and then "Brand" the system with your name and
  650.       serial number.
  651.          ┌─────────────────────────────────────────────────────────────┐
  652.          │ ╒═╡ Select the INSTALLATION FUNCTION ╞═══════════════════╕  │
  653.          │ │ Install system     Brand system       eXit             │█ │
  654.          │ ╘════════════════════════════════════════════════════════╛█ │
  655.          │  ██████████████████████████████████████████████████████████ │
  656.          └─────────────────────────────────────────────────────────────┘
  657.  
  658. ┌──────────────────────────────────────────────────────────────────────────────┐
  659. │╒═╡ File Name   Status  Hard Disk Path/File Description    ENVI-MAN FILES ╞═╕ │
  660. ││ System═>ENVI-MAN      Environment data summary, environ. space remaining  │█│
  661. ││ ENVI-MAN.COM  PROCESS Utility program                                     │█│
  662. ││ YYYY.YYY      PROCESS Other files                                         │█│
  663. │╘═╡ INSTALLATION PATH═>C:\ENVI ╞════════════════════════════════════════════╛█│
  664. │ █████████████████████████████████████████████████████████████████████████████│
  665. └──────────────────────────────────────────────────────────────────────────────┘
  666.  
  667.       -> To install ENVI-MAN on the hard  disk, insure that the highlight bar is
  668.          on the "INSTALL SYSTEM" FUNCTION and press  ENTER . Each of the file(s)
  669.          will be copied to the selected installation drive-directory. 
  670.  
  671.           NOTE    A  happy face symbol after any of  the system's file names de-
  672.                   notes that this  file is already on the hard  disk. During in-
  673.                   stallation it  will be  replaced, on  the  directory where  it
  674.                   currently resides, not the INSTALLATION DRIVE-DIRECTORY PATH.
  675.  
  676.          When all files have been copied to the hard  disk, a copy complete mes-
  677.          sage is displayed.
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686. 12
  687.  
  688.            ENVI-MAN Version 1.0                      INSTALLING THE SYSTEM
  689.  
  690.         ┌───────────────────────────────────────────────────────────────┐
  691.         │ ┌─┤ MESSAGE ├──────────────────────────────────────────────┐  │
  692.         │ │ FILE COPY COMPLETED.                                     │█ │
  693.         │ │ All of the required BOOK-IT! files are on the hard disk. │█ │
  694.         │ │ ═══> BOOK-IT! IS READY TO RUN. <═══                      │█ │
  695.         │ └──────────────────────────────────────────────────────────┘█ │
  696.         │  ████████████████████████████████████████████████████████████ │
  697.         └───────────────────────────────────────────────────────────────┘
  698.  
  699.          -> To cancel the installation at this point, press  ESCAPE .
  700.          -> To  continue with the installation,  press any other  key. The high-
  701.             light bar will then be on the "BRAND SYSTEM" FUNCTION.
  702.  
  703.    8. -> To brand  the system with your  name and serial number,  move the high-
  704.          light bar to the "BRAND SYSTEM" FUNCTION and press  ENTER . A REGISTRA-
  705.          TION INFORMATION data entry  window will be displayed, as  shown below,
  706.          with sample data already entered. 
  707.  
  708.           NOTE    This  step is REQUIRED for ENVI-MAN to be registered. Also, if
  709.                   you  move the  ENVI-MAN files  to another  drive-directory you
  710.                   will need to "BRAND" the system again.
  711.  
  712.          Enter your company and/or  your name, and then the  system registration
  713.          number. Your  registration number is located  on the back of  the front
  714.          cover of this manual.
  715.                   ┌──────────────────────────────────────────┐
  716.                   │ ┌─┤ REGISTRATION INFORMATION ├────────┐  │
  717.                   │ │ Name ABC COMPANY, George Jones      │█ │
  718.                   │ │ Registration number 12345678        │█ │
  719.                   │ └─────────────────────────────────────┘█ │
  720.                   │  ███████████████████████████████████████ │
  721.                   └──────────────────────────────────────────┘
  722.  
  723.          -> To accept either  the name  or registration number  after entry  and
  724.             editing, press  ENTER . A message will be displayed after the regis-
  725.             tration number  is entered. It's  contents are dependent  on whether
  726.             the registration number is valid. Both messages are shown below.
  727.                 ┌───────────────────────────────────────────────┐
  728.                 │ ┌─┤ MESSAGE ├──────────────────────────────┐  │
  729.                 │ │ BOOK-IT! serial number entered is VALID. │█ │
  730.                 │ └──────────────────────────────────────────┘█ │
  731.                 │  ████████████████████████████████████████████ │
  732.                 └───────────────────────────────────────────────┘
  733.  
  734.                ┌─────────────────────────────────────────────────┐
  735.                │ ┌─┤ MESSAGE ├────────────────────────────────┐  │
  736.                │ │ BOOK-IT! serial number entered is INVALID! │█ │
  737.                │ │ Please try again.                          │█ │
  738.                │ └────────────────────────────────────────────┘█ │
  739.                │  ██████████████████████████████████████████████ │
  740.                └─────────────────────────────────────────────────┘
  741.  
  742.  
  743.  
  744.                                                                               13
  745.  
  746.            INSTALLING THE SYSTEM                      ENVI-MAN Version 1.0
  747.  
  748.             -> To  continue with the installation program, press any key. If the
  749.                registration number was valid,  the "EXIT" option is highlighted.
  750.                If it was invalid, select the "BRAND SYSTEM" option again.
  751.  
  752.    9. -> To exit from the  installation program, move  the highlight bar to  the
  753.          "EXIT"  FUNCTION and  press  ENTER .  If the  system has  been properly
  754.          branded, the program will exit,  and ENVI-MAN is ready for use.  If the
  755.          system has  not been branded, an  error message is displayed,  as shown
  756.          below.
  757.        ┌─────────────────────────────────────────────────────────────────┐
  758.        │ ┌─┤ MESSAGE ├────────────────────────────────────────────────┐  │
  759.        │ │ This system has not been 'BRANDED'.                        │█ │
  760.        │ │ In order to be registered, it must first be 'BRANDED'!     │█ │
  761.        │ │ To exit without BRANDING, press ESCAPE.                    │█ │
  762.        │ │ To continue with the INSTALL program, press any other key. │█ │
  763.        │ └────────────────────────────────────────────────────────────┘█ │
  764.        │  ██████████████████████████████████████████████████████████████ │
  765.        └─────────────────────────────────────────────────────────────────┘
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802. 14
  803.  
  804.  
  805.                                                                RUNNING ENVI-MAN 
  806.  
  807. The syntax to execute the ENVI-MAN utility program is: 
  808.  
  809.    ENVI-MAN [option a] [option ...] [requested environment memory]
  810.  
  811. The command  line options provide information to ENVI-MAN that will override the
  812. default options that are in effect at the beginning of the program.
  813.  
  814. A space MUST be present after the program name and any  command line parameters.
  815. Spaces between options and requested environment memory are optional.
  816.  
  817. Options  
  818.  
  819. none  If  no options or requested environment memory are specified ENVI-MAN will
  820.       display the program syntax.
  821.  
  822. +     Calculate  the Available  Environment Space  using the  Master Environment
  823.       Size  and any currently free memory available immediately above the Master
  824.       Environment. Set the DOS ERRORLEVEL variable equal to the value calculated
  825.       using  the  rules detailed  in  the section  "Available  Environment Space
  826.       ERRORLEVEL Calculation". This is the default.
  827.  
  828. -     Calculate the  Available Environment Space using only  the Master Environ-
  829.       ment Size. Set  the DOS ERRORLEVEL variable equal to  the value calculated
  830.       using  the rules  detailed  in the  section  "Available Environment  Space
  831.       ERRORLEVEL Calculation".
  832.  
  833. s     Display  a single summary  line specifying the  Available Environment Size
  834.       and the value  to which ERRORLEVEL is  set. This display does  not cause a
  835.       pause nor is any user action required.
  836.  
  837. d     Displays  each of the current  environment strings along  with its length.
  838.       Additionally  data is  displayed about  the master environment  size, free
  839.       memory above  the master environment, current  environment size, available
  840.       environment space and the value of ERRORLEVEL.
  841.  
  842. x     Suppress the error  message display on Insufficient Environment  Space re-
  843.       maining.
  844.  
  845. Requested Environment Memory  
  846.  
  847. nnnnn (0-32767) If  a numeric value  is placed on the  command line, it  will be
  848.       treated as  a request to test for the availability of a corresponding num-
  849.       ber of bytes of  environment space. This number  will then be used in  the
  850.       calculation of the  ERRORLEVEL variable  using the rules  detailed in  the
  851.       section "Available Environment Space ERRORLEVEL Calculation".
  852.  
  853. Shareware message  
  854.  
  855. A  shareware message may be randomly displayed  at the end of ENVI-MAN. Pressing
  856. any key will exit the program.
  857.  
  858. The use  of the "X" option  to suppress display of  the Insufficient Environment
  859.  
  860.                                                                               15
  861.  
  862.            RUNNING ENVI-MAN                           ENVI-MAN Version 1.0
  863.  
  864. Space Remaining will not affect the shareware message display.
  865.  
  866. By registering  you use of  ENVI-MAN, you will be  able to use  the registration
  867. serial number to suppress the shareware message display.
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918. 16
  919.  
  920.  
  921.                                                               MASTER AND PROGRAM
  922.                                                                     ENVIRONMENTS
  923.  
  924. Master Environment  
  925.  
  926. When the  computer is  first booted, a  Master Environment  is established.  Its
  927. default size is 160 bytes for DOS versions 3.x and 4.x and 256 bytes for version
  928. 5.0. This size may  be changed, in sixteen byte increments up  to a maximum size
  929. of 32,767, by  use of the SHELL  and COMMAND statements in  the CONFIG.SYS file.
  930. Details of these commands may be found in the DOS manual. For any changes to the
  931. CONFIG.SYS  file to  become effective, the  system must  be re-booted  after the
  932. changes are made.
  933.  
  934. The contents  of the  Master Environment  are environment  strings, each  in the
  935. following format:
  936.  
  937.    NAME = STRING[ASCII 0]
  938.  
  939. As can be seen  from the format, the  minimum environment string length is  four
  940. bytes.
  941.  
  942. An example environment string is -
  943.  
  944.    PATH=C:\
  945.  
  946. The length of the above example is nine bytes.
  947.  
  948. The Master Environment  strings may be created or changed by use of the DOS com-
  949. mands such as PROMPT, PATH and SET. An example would be- 
  950.    SET GOOD=EMPIRE
  951.    SET BAD=KLINGONS
  952.    PROMPT=$P$G
  953.  
  954. Program Environment  
  955.  
  956. When a  program is executed, the loader  (which is called by  COMMAND.COM and is
  957. DOS Int 21h  - EXEC), establishes a copy of the  environment for use by the pro-
  958. gram. It  first copies all of  the environment strings from  the Master Environ-
  959. ment(or, if this is a child process, from the parent's environment). These envi-
  960. ronment strings are then terminated by a three character sequence of:
  961.  
  962.    [ASCII 0][ASCII 1][ASCII 0]
  963.  
  964. The environment  strings are followed by the complete path of the loaded program
  965. using the format:
  966.  
  967.    D:\[subdirectory path\]NNNNNNNN.EEE[ASCII 0]
  968.  
  969.       where:
  970.          D:\            disk drive from which the program is being loaded,
  971.          subdirectory path\   path of the program being loaded,
  972.          NNNNNNNN    name of the program,
  973.          .EEE           extension of the program.
  974.  
  975.  
  976.                                                                               17
  977.  
  978.            MASTER AND PROGRAM ENVIRONMENTS            ENVI-MAN Version 1.0
  979.  
  980. The program  environment is then  sized up to  a paragraph boundary so  that its
  981. size in bytes is always a multiple of sixteen.
  982.  
  983. Master Environment Expansion  
  984.  
  985. One interesting fact is that the size of the  Master Environment may, under cer-
  986. tain circumstances, exceed its default size or the size defined in CONFIG.SYS.
  987.  
  988. The Master environment is preceded by a 16 byte Memory Control Block (MCB) which
  989. give the memory block size and the address of its owner. If the address is zero,
  990. the memory block is free. 
  991.  
  992. In some  cases while  booting, Terminate  and Stay  Resident (TSR)  programs are
  993. loaded. Their program  environment is  allocated before the  program is  loaded.
  994. Some  TSR's will  release their  environment memory allocation  before returning
  995. control to the command processor. If the  size of the environment does not grow,
  996. these free  memory holes can be used to load  the environment for later TSR's or
  997. other programs. However, if the size of the environment does increase, there may
  998. be few uses for these free memory areas and they may remain unused.
  999.  
  1000. In the  situation just described,  memory allocation in  the area of  the Master
  1001. Environment might  look as detailed  below. ENV_SIZE is  the default or  defined
  1002. value for the Master Environment.
  1003.  
  1004. Memory Control Block 1  (=16 bytes)
  1005.                   {OWNER=COMMAND.COM}
  1006.                   {MEMORY_SIZE=ENV_SIZE}
  1007.  
  1008. Master Environment      (=ENV_SIZE bytes)
  1009.  
  1010. Memory Control Block 2  (=16 bytes)
  1011.                   {OWNER=FREE}
  1012.                   {MEMORY_SIZE=X}
  1013.  
  1014. Free Memory       (=X bytes (a multiple of 16))
  1015.  
  1016. Memory Control Block 3  (=16 bytes)
  1017.                   {OWNER=SOMEONE}
  1018.                   {MEMORY_SIZE=Z}
  1019.  
  1020. Note that MCB 2 and its associated memory block are free. Now for the fun part! 
  1021.  
  1022. If  a request is  made to COMMAND.COM  to increase the  size of the environment,
  1023. such  as with a  SET statement and  the size of  the new environment  would then
  1024. exceed that  as defined  by ENV_SIZE,  it WILL NOT  display "Out  of environment
  1025. space". Rather, it will  obtain the needed memory from MCB 2  and its associated
  1026. block. 
  1027.  
  1028. Lets  assume that there  was a Master  Environment (ENV_SIZE) of  160 bytes, the
  1029. current length of the environment strings was 155 bytes and the SET command will
  1030. add 10 bytes to the size of the environment strings.
  1031.  
  1032. COMMAND.COM will:
  1033.  
  1034. 18
  1035.  
  1036.            ENVI-MAN Version 1.0            MASTER AND PROGRAM ENVIRONMENTS
  1037.  
  1038.    1. Increase the size of the memory block specified in MCB 1 by 16 bytes.
  1039.    2. This increases the size of the Master Environment by 16 bytes.
  1040.    3. Relocate MCB 2 16  bytes higher and decrease the size  of its memory block
  1041.       by 16 bytes.
  1042.    4. This decreases the size  of the free memory block associated with MCB 2 by
  1043.       16 bytes. 
  1044.  
  1045. This area of memory will now look like:
  1046.  
  1047. Memory Control Block 1  (=16 bytes)
  1048.                   {OWNER=COMMAND.COM}
  1049.                   {MEMORY_SIZE=ENV_SIZE+16}
  1050.  
  1051. Master Environment      (=ENV_SIZE+16 bytes)
  1052.  
  1053. Memory Control Block 2  (=16 bytes)
  1054.                   {OWNER=FREE}
  1055.                   {MEMORY_SIZE=X-16}
  1056.  
  1057. Free Memory       (=X-16 bytes (a multiple of 16))
  1058.  
  1059. Memory Control Block 3  (=16 bytes)
  1060.                   {OWNER=SOMEONE}
  1061.                   {MEMORY_SIZE=Z}
  1062.  
  1063. This procedure can continue - Master Environment increasing by 16 bytes and Free
  1064. Memory and its MCB 2 decreasing by 16 bytes - until both the Free Memory AND MCB
  1065. 2 have been incorporated into the Master Environment! 
  1066.  
  1067. Note that MCB 3 is not involved, since, if MCB 3 pointed to a free memory block,
  1068. it would normally be  incorporated into MCB  2. However, if MCB  3 did point  to
  1069. free memory, it could eventually be used by the  Master Environment after all of
  1070. MCB 2 and its free memory was used.
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.                                                                               19
  1093.  
  1094.            MASTER AND PROGRAM ENVIRONMENTS            ENVI-MAN Version 1.0
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150. 20
  1151.  
  1152.  
  1153.                                                               ENVI-MAN OPERATION
  1154.  
  1155. Program Syntax  
  1156.  
  1157. A program syntax message is displayed if:
  1158.  
  1159.    *  No command line parameters are specified. Or,
  1160.    *  Any of the command line parameters is invalid.
  1161.  
  1162. The program syntax message is shown below.
  1163.  ┌─────────────────────────────────────────────────────────────────────────────┐
  1164.  ┌┤ ENVI-MAN Version 1.02, Copyright 1991-92 Micrometric, All rights reserved ├┐
  1165.  │The program syntax is:  ENVI-MAN [options][requested environment memory]     │
  1166.  │   options = none, display syntax                                            │
  1167.  │             +, calculate ERRORLEVEL using Free Memory Above Master (default)│
  1168.  │             -, calculate ERRORLEVEL using only Master Size                  │
  1169.  │             d, display Environment Data                                     │
  1170.  │             s, display Environment Space Remaining Summary line             │
  1171.  │             x, suppress displays including Insufficient Environment Message │
  1172.  │ requested = nnnnn, optional decimal bytes of environment memory needed      │
  1173.  │ERRORLEVEL = AVAILABLE ENVIRONMENT SPACE + Free(optional) - Requested(opt.)  │
  1174.  │           = 0, no Environment Space Remaining                               │
  1175.  │           = 1-254, bytes Environment Space Remaining                        │
  1176.  │           = 255, greater that 254 bytes Environment Space Remaining         ┴
  1177.  └────────────────────────────────┤ ENVI-MAN syntax, Press any key to continue..
  1178.  └─────────────────────────────────────────────────────────────────────────────┘
  1179.  
  1180. -> If this message is displayed, correct the program syntax and rerun.
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.                                                                               21
  1209.  
  1210.            ENVI-MAN OPERATION                         ENVI-MAN Version 1.0
  1211.  
  1212. Environment Data Display  
  1213.  
  1214. ENVI-MAN has  two major functions: an  informational one and a  testing one. The
  1215. Environment Data Display is its primary informational tool.
  1216.  
  1217. To obtain the Environment Data Display, use the syntax -
  1218.  
  1219.    ENVI-MAN D
  1220.  
  1221. A sample of the resulting  Environment Data Display is shown below.  An explana-
  1222. tion of its information follows.
  1223.  ┌─────────────────────────────────────────────────────────────────────────────┐
  1224.  ┌┤ ENVI-MAN Version 1.02, Copyright 1991-92 Micrometric, All rights reserved ├┐
  1225.  │ COMSPEC=C:\DOS\COMMAND.COM ─> 27                                            │
  1226.  │ DOS=DOS-330 ─> 12                                                           │
  1227.  │ PATH=C:\BAT;C:\DOS-330;C:\UTILITY;C:\ ─> 38                                 │
  1228.  │ PROMPT=$e[36;44;1m$t$h$h$h$h$h$h $d$h$h$h$h$h $p$g$e[37;44;1m ─> 62         │
  1229.  │C:\UTILITY\ENVI-MAN.COM ─> 24                                               │
  1230.  └─────┤ Current Environment Strings ─> String Length ├────────────────────────┘
  1231.  │       Master Environment Location <> 0E36:0000                              │
  1232.  │           MASTER ENVIRONMENT SIZE ═> 320                                    │
  1233.  │          Free Memory Above Master +> 80                                     │
  1234.  │  POSSIBLE MASTER ENVIRONMENT SIZE ≈> 400                                    │
  1235.  │     Number Of Environment Strings <> 4                                      │
  1236.  │        Environment Strings Length +> 140                                    │
  1237.  │              Program Path Length +> 26                                     │
  1238.  │          Current Environment Size ═> 176                                    │
  1239.  │       AVAILABLE ENVIRONMENT SPACE ═> 180                                    │
  1240.  │  POSSIBLE AVAIL ENVIRONMENT SPACE ≈> 260                                    │
  1241.  │      Requested Environment Memory ─> 0                                      │
  1242.  │                 ERRORLEVEL SET TO ═> 255, Press any key to continue..       │
  1243.  └─────────────────────────────────────────────────────────────────────────────┘
  1244.  
  1245. The program line shows the current ENVI-MAN version.
  1246. The boxed lines,  except for the  last, are the  current Master Environment  and
  1247.    Program Environment strings.  At the end of each string  is its length, which
  1248.    includes its terminating zero byte.
  1249. The last boxed line is the program path that is included in the Program Environ-
  1250.    ment. At its end is its length, including its terminating zero byte.
  1251.  
  1252. MASTER ENVIRONMENT LOCATION . . . . The segment address and offset (always zero)
  1253.    at which the Master Environment is  located. Its MCB is located one paragraph
  1254.    lower.
  1255. MASTER ENVIRONMENT SIZE . . . .  The current Master Environment size, not neces-
  1256.    sarily the default or defined size.
  1257. FREE MEMORY ABOVE MASTER  . . . . . The  size of any  contiguous free memory in-
  1258.    cluding its associated MCB above the Master Environment.
  1259. POSSIBLE MASTER ENVIRONMENT SIZE  . The  possible  maximum  size of  the  Master
  1260.    Environment if the currently available free memory is included.
  1261. NUMBER OF ENVIRONMENT STRINGS .  The  number  of  currently defined  environment
  1262.    strings.
  1263.  
  1264.  
  1265.  
  1266. 22
  1267.  
  1268.            ENVI-MAN Version 1.0                         ENVI-MAN OPERATION
  1269.  
  1270. ENVIRONMENT STRINGS LENGTH  . .  The size of all  of the currently defined envi-
  1271.    ronment  strings. This size includes the strings termination zero byte, since
  1272.    this byte is required in the Master Environment.
  1273. PROGRAM PATH LENGTH . . . . . .  The length  of the  program path string  in the
  1274.    Program Environment. This size includes the termination zero byte and the two
  1275.    bytes that separate the environment strings from the program path.
  1276. CURRENT ENVIRONMENT SIZE  . . . . . The  size of  the current  environment. This
  1277.    size set by COMMAND.COM and is always a multiple of 16 bytes.
  1278. AVAILABLE ENVIRONMENT SPACE . . . . Currently  defined  MASTER ENVIRONMENT  SIZE
  1279.    less the  currently defined  ENVIRONMENT STRINGS LENGTH.  The available  free
  1280.    space in the currently defined Master Environment.
  1281. POSSIBLE AVAIL ENVIRONMENT SPACE  . The  AVAILABLE  ENVIRONMENT  SPACE plus  the
  1282.    FREE MEMORY ABOVE MASTER Environment space.
  1283. REQUESTED ENVIRONMENT MEMORY  .  The  amount of  environment  memory  needed  as
  1284.    requested in the ENVI-MAN command line parameters.
  1285. ERRORLEVEL SET TO . . . . . . . . . The  value calculated  by ENVI-MAN  to which
  1286.    the ERRORLEVEL  variable is set upon  program exit. For the  formula used for
  1287.    this  calculation, see  the section  "AVAILABLE ENVIRONMENT  SPACE ERRORLEVEL
  1288.    CALCULATION" later in this chapter.
  1289.  
  1290. Environment Space Remaining Display  
  1291.  
  1292. To display a single summary line on the environment space status, use the syntax
  1293. -
  1294.  
  1295.    ENVI-MAN S
  1296.  
  1297. An example of the  resulting display is  shown below. For  the formula used  for
  1298. this calculation, see the section "AVAILABLE ENVIRONMENT SPACE ERRORLEVEL CALCU-
  1299. LATION" later in this chapter.
  1300.  ┌─────────────────────────────────────────────────────────────────────────────┐
  1301.  │ Environment Space Remaining ═> 255                                          │
  1302.  └─────────────────────────────────────────────────────────────────────────────┘
  1303.  
  1304. Additional Environment Space Required Display  
  1305.  
  1306. If, based on the defaults  and the command line parameters, there  is not suffi-
  1307. cient environment  space remaining,  an informational  message is displayed,  as
  1308. shown below. This message ONLY appears  if reserved memory has been specified on
  1309. the command line AND the "X" suppress option is NOT specified.
  1310.  ┌─────────────────────────────────────────────────────────────────────────────┐
  1311.  ┌┤ ENVI-MAN Version 1.02, Copyright 1991-92 Micrometric, All rights reserved ├┐
  1312.  │The amount of Additional Environment Memory requested for this batch file is │
  1313.  │greater than the currently available Environment Space. This means that if   │
  1314.  │execution of this batch file continued, the operating system would display   │
  1315.  │the message "out of environment space" and terminate the batch file. In order│
  1316.  │to run this batch file (assuming no free memory above the Master Environment)│
  1317.  │you MUST decrease the environment strings length OR increase the size of the │
  1318.  │ENVIRONMENT space using the SHELL statement in your CONFIG.SYS file.         ┴
  1319.  └──┤ Additional Environment Space Required ═> 120, Press any key to continue..│
  1320.  └─────────────────────────────────────────────────────────────────────────────┘
  1321.  
  1322. The displayed "Additional Environment Space Required"  NEVER includes any possi-
  1323.  
  1324.                                                                               23
  1325.  
  1326.            ENVI-MAN OPERATION                         ENVI-MAN Version 1.0
  1327.  
  1328. ble  free memory above the Master  Environment. This is the  amount by which the
  1329. defined environment  size should be increased  in order to run  the program with
  1330. the desired environment information. Possible free memory is not used since this
  1331. value is how much the Master Environment
  1332. needs to be increased.
  1333.  
  1334. The Master Environment size  may be changed, in sixteen byte increments  up to a
  1335. maximum size of 32,767, by use of the SHELL and COMMAND  statements in the CONF-
  1336. IG.SYS file. Details of these  commands may be found in the DOS  manual. For any
  1337. changes to the CONFIG.SYS file to become effective, the system must be re-booted
  1338. after the changes are made.
  1339.  
  1340. If sufficient  environment space was not  available, this message WOULD  BE dis-
  1341. played with the syntax -
  1342.  
  1343.    ENVI-MAN 2000
  1344.  
  1345. and WOULD NOT BE displayed with the syntax -
  1346.  
  1347.    ENVI-MAN 2000X
  1348.  
  1349.  
  1350. Available Environment Space ERRORLEVEL calculation  
  1351.  
  1352. The ERRORLEVEL variable  is used to denote  the amount of Available  Environment
  1353. Space and is calculated as follows:
  1354.  
  1355. ERRORLEVEL  =  Master Environment Size
  1356.             -  Environment Strings Size
  1357.             +  Free Memory Above Master Environment (optional)
  1358.             -  Requested Environment Memory (optional)
  1359.  
  1360.       If  ERRORLEVEL is  negative  (there is  not  enough Available  Environment
  1361.       Space), it is set equal to zero to denote an error condition.
  1362.  
  1363.       If ERRORLEVEL, as  calculated, is equal to  zero (there is exactly  enough
  1364.       current Available Environment Space), it  is set equal to one to  denote a
  1365.       non-error condition.
  1366.  
  1367.       If ERRORLEVEL is greater than 254, it is set equal to 255.
  1368.  
  1369. A summary of the various ERRORLEVEL  values and their relationship to the Avail-
  1370. able Environment Space is shown below.
  1371.  
  1372.    ERRORLEVEL     Available Environment Space
  1373.  
  1374.       0           -32767 to -1
  1375.       1           0 to 1
  1376.       2-254       Same as ERRORLEVEL
  1377.       255            255 to 32767
  1378.  
  1379.  
  1380.  
  1381.  
  1382. 24
  1383.  
  1384.  
  1385.                                                                   ENVI-MAN BATCH
  1386.                                                                    FILE EXAMPLES
  1387.  
  1388. Shown below are several examples of the use of ENVI-MAN in batch files.
  1389.  
  1390. -> To assure that  an environment variable  of 8 character  storage size may  be
  1391.    added and to display your own message if there is insufficient space, use the
  1392.    following batch file code:
  1393.  
  1394.    ...
  1395.    ENVI-MAN +8X    (or ENVI-MAN 8X)
  1396.    IF NOT ERRORLEVEL 1 GOTO NOFIT
  1397.    ...
  1398.    :NOFIT
  1399.    ECHO DO THIS AND THAT BECAUSE
  1400.    ECHO  THERE IS NOT ENOUGH SPACE
  1401.    ECHO  IN THE ENVIRONMENT.
  1402.    ...
  1403.  
  1404.       The batch  file code shown  below will  produce the same  results at  that
  1405.       above (without the requested  environment memory parameter the "Additional
  1406.       Environment Space Required Display" can never occur and thus the  "X" sup-
  1407.       press option is not needed):
  1408.  
  1409.    ...
  1410.    ENVI-MAN +
  1411.    IF NOT ERRORLEVEL 8 GOTO NOFIT
  1412.    ...
  1413.    :NOFIT
  1414.    ECHO DO THIS AND THAT BECAUSE
  1415.    ECHO  THERE IS NOT ENOUGH SPACE
  1416.    ECHO  IN THE ENVIRONMENT.
  1417.    ...
  1418.  
  1419.  
  1420. -> To assure that  an environment variable  of 8 character  storage size may  be
  1421.    added and let ENVI-MAN display a  message if there is insufficient space, use
  1422.    the following batch file code:
  1423.  
  1424.    ...
  1425.    ENVI-MAN +8    (or ENVI-MAN 8)
  1426.    IF NOT ERRORLEVEL 1 GOTO EXIT
  1427.    ...
  1428.    :EXIT
  1429.    ...
  1430.  
  1431. -> To display  the amount of available  environment space on a  single line, use
  1432.    the following batch file code:
  1433.  
  1434.    ...
  1435.    ENVI-MAN +S    (or ENVI-MAN S)
  1436.    ...
  1437.  
  1438.  
  1439.  
  1440.                                                                               25
  1441.  
  1442.            ENVI-MAN BATCH FILE EXAMPLES               ENVI-MAN Version 1.0
  1443.  
  1444. -> To display the environment data,  use the following code (this syntax  may be
  1445.    used in a batch file or entered at the DOS prompt):
  1446.  
  1447.    ENVI-MAN D
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498. 26
  1499.